Piattaforma di Gestione Rete RA Italia

Panoramica del Sistema

CRO (Central Routing Optimizer) è una piattaforma enterprise sviluppata per l'analisi di fattibilità, il rilascio e la gestione dei collegamenti DWDM (Dense Wavelength Division Multiplexing) e fibra ottica su due reti Telecom Italia: RC Italia (Rete Core) e RA Italia (Rete di Aggregazione).

Il sistema integra un motore di calcolo percorsi avanzato basato su algoritmo Dijkstra modificato, database separati per RC e RA con migliaia di collegamenti, e visualizzazioni geografiche interattive su mappe topografiche OpenStreetMap.

Ambito di Applicazione

CRO è progettato per supportare:

• Richieste di Fattibilità Tecnica - Verifica rapida della realizzabilità di nuovi collegamenti su entrambe le reti
• Riconfigurazioni di Rete - Analisi impatto e percorsi alternativi per modifiche topologiche
• Verifiche di Percorso - Controllo tracciati esistenti e conformità progettuale
• Analisi Manutentive - Studio collegamenti NON ATTIVI e possibili ripristini
• Scenari Alternativi - Simulazioni what-if per disaster recovery e resilienza
• Ottimizzazione Routing - Identificazione percorsi più efficienti per riduzione latenza/costi
• Capacity Planning - Supporto decisionale per investimenti infrastrutturali

🔄 Processo di Fattibilità — Workflow Operativo

Il processo di fattibilità per servizi di connettività TIM si articola in due macro-scenari principali, che coinvolgono diverse componenti dell'infrastruttura di rete. L'analisi richiede l'utilizzo coordinato dei tool NAT (National Topography) e CRO (Central Routing Optimizer).

Componenti Architetturali Principali

Stack Tecnologico

Metriche di Performance

Architettura Three-Tier

CRO adotta un'architettura three-tier (presentazione, logica, dati) completamente client-side per massimizzare performance e ridurre latenza. Non richiede server backend per operazioni ordinarie.

Flusso Dati Operativo

Workflow tipico di una ricerca percorsi:

1. Input Utente → Form "Ricerca Percorsi" con selezione A/Z e vincoli
2. Validazione Input → Controllo esistenza centrali, coerenza vincoli, range valori
3. Preprocessing → Costruzione grafo di rete da database, applicazione filtri stato
4. Algoritmo Dijkstra → Calcolo K-shortest paths (K=30) con vincoli attivi
5. Path Diversification → Calcolo 10 percorsi Div con overlap <30% rispetto a 1.1
6. Postprocessing → Eliminazione duplicati, ordinamento distanza, aggregazione metadati
7. Rendering Risultati → Popolamento tabelle HTML, disegno percorsi su mappa
8. User Interaction → Selezione percorsi, zoom mappa, export TXT/CSV

Gestione Stato Applicazione

Lo stato applicativo è gestito tramite pattern Observable con listeners su eventi DOM. Variabili globali di stato includono:

Sicurezza e Validazione

Meccanismi di sicurezza implementati:

• Input Sanitization - Escape caratteri speciali, validazione range numerici
• SQL Injection Prevention - N/A (no backend SQL, solo JSON client-side)
• XSS Protection - textContent invece di innerHTML per user input
• CSRF Protection - N/A (applicazione stateless senza autenticazione)
• Rate Limiting - Throttling ricerche (max 1/secondo) per prevenire abuse
• Data Validation - Schema validation per tutti i record database

Scalabilità e Performance

1. Algoritmo Dijkstra Vincolato

Calcolo automatico fino a 30 percorsi primari (Std) ottimizzati per distanza e 10 alternativi diversificati (Div). Supporta vincoli multipli:

• Centrali obbligatorie (selezione multipla)
• Centrali da evitare (blacklist)
• Distanza min/max in km
• Collegamenti min/max (hop count)
• Toggle "Solo Collegamenti NON ATTIVI" per analisi su tratte dismesse

2. Database Enterprise RC Italia

Repository con 500+ centrali e metadati completi. Funzionalità:

• Ricerca case-insensitive su ID, GAT, CLLI, Nome
• Filtri per Zona (NORD/CENTRO/SUD), Area, Regione
• Personalizzazione colonne visualizzate
• Export CSV con encoding UTF-8 BOM
• Selezione multipla per operazioni batch

3. Geocodifica & Centrale più Vicina

Conversione automatica indirizzo → coordinate WGS84 tramite Nominatim API OpenStreetMap. Algoritmo Haversine per calcolo distanze ortodromiche. Identificazione automatica della centrale più vicina con indicatore permanente sulla mappa.

4. Mappa Topografica Interattiva

Visualizzazione con Leaflet.js e auto-inizializzazione. Features:

• Overlay percorsi con codifica colori (primari blu, alternativi arancione)
• Layer control per gestione visibilità
• Misurazione distanze tra due punti (attivabile)
• Zoom automatico su selezione o intera rete
• Highlight mode per evidenziare percorsi specifici

5. Calcolatore Attenuazione ITU-T

Stima professionale perdite in fibra ottica secondo standard ITU-T. Layout ottimizzato a 2 colonne:

• Colonna Sinistra: Form input (tipo fibra, lunghezza, collegamenti) + risultato stile "Riepilogo Economico" con tabella dettagliata
• Colonna Destra: Legenda con formula ITU-T, tabella coefficienti α (dB/km), note connettorizzazioni, esempio pratico
• Multimodale (MM): 850 nm (α=3.0 dB/km), 1300 nm (α=1.0 dB/km)
• Monomodale (SM): 1310 nm (α=0.35 dB/km), 1550 nm (α=0.22 dB/km)
• Calcolo perdite connettorizzazioni (0.3 dB cadauna, 2 per bretella)
• Output formattato: tipo fibra, km, collegamenti, perdita fibra, perdita connettori, totale dB

6. Sistema Undo Intelligente

Cronologia automatica delle ultime 20 ricerche con salvataggio completo parametri. Ripristino istantaneo con un click. Persistenza in localStorage tra sessioni browser. Risparmio stimato: da 5 minuti a 5 secondi!

7. Export Multi-formato

Export percorsi in formato TXT (percorsi Std e Div separati) e CSV per elaborazioni Excel. Bottone "Copia Formattata" per clipboard. Output CR/GI ready.

8. Analisi Costi per Fattibilità

Modulo dedicato alla stima dei costi associati a Link, Code Cliente e Apparati/Cestelli. Features:

• Riepilogo economico calcolato in tempo reale
• Selezione multipla su tre pannelli: Link RA/RC, Coda Cliente, Apparati
• Visualizzazione costi con e senza sconto
• Export riepilogo in formato TXT

9. S.d.F Internalizzati

Sistema di analisi fattibilità internalizzate con caricamento file Excel:

• Parsing automatico colonne: Fattibilità, Tipo, Esito, Priorità, Scadenza, Territorio
• 6 grafici interattivi (Per Esito, Per Tipo, Per Priorità, Per Territorio, Esito Aggregato, Scadenze)
• Tabella filtrabile con ricerca su S.d.F, Cliente, Territorio
• Export CSV dei dati filtrati

10. Confronto DB Excel

Tool per verifica allineamento tra due versioni di database Excel:

• Confronto foglio per foglio, cella per cella
• Report TXT dettagliato delle differenze
• Export JSON del primo foglio del DB nuovo
• Statistiche: fogli confrontati, celle confrontate, differenze trovate

11. Marker Centrali su Mappa

Visualizzazione delle centrali di inizio e fine per ogni collegamento sulla mappa dei percorsi:

• Marker circolari blu con popup informativo
• Nome Centrale e CLLI visibili al click
• Deduplicazione automatica delle centrali ripetute
• Supporto completo per DB RA e DB RC

12. Filtro POP (NODO A1)

Toggle per filtrare le 32 centrali POP nazionali (NODO A1) come destinazione percorsi:

• Attivabile nei campi "Centrale di Arrivo" di entrambe le sezioni RC e RA
• Lista delle 32 centrali POP: ROMA, MILANO, TORINO, NAPOLI, BOLOGNA, FIRENZE, ecc.
• Match esatto sul CLLI (evita centrali omonime)
• Placeholder dinamico con indicatore visivo rosso quando attivo

13. Colorazione e Conteggio Collegamenti RA

Sistema di colorazione semantica e conteggio personalizzato per i collegamenti RA:

• Verde (T1↔T2, T2↔T2): Collegamenti principali, contano 1 ciascuno
• Blu TIM (T2↔T3): Collegamenti intermedi, contano 0.5 (ogni 2 = 1)
• Standard (T3↔T3): Collegamenti di transito, non contano
• Centrali di partenza e arrivo evidenziate in grassetto
• Percorsi diversificati automatici verso altra Tipo 1 sullo stesso arco

14. Gestione Archi Multipli e Selezione Obbligatoria (RA)

Sistema di rilevamento e gestione quando due centrali appartengono a più archi compatibili:

• Rilevamento automatico: il sistema verifica se le centrali di Partenza e Arrivo sono presenti su più archi
• Mini-label di avviso: quando gli archi compatibili sono multipli, compare il messaggio "⚠️ Più archi compatibili: seleziona 1 arco nella sezione Filtro per Arco per calcolare"
• Selezione obbligatoria: prima di calcolare il percorso, è necessario selezionare un singolo arco dal filtro "🔍 Filtro per Arco (Checkbox)"
• Disambiguazione percorso: la selezione dell'arco determina univocamente il percorso da calcolare lungo quella specifica direttrice
• Bottone [Premi Qui]: se una centrale appartiene a più archi, appare un bottone per visualizzare la lista completa degli archi

15. Ricerca Multi-Arco (RA)

Funzionalità avanzata per calcolare tutti i percorsi su tutti gli archi compatibili tra due centrali:

• 🔀 Multi-Arco: bottone dedicato che calcola contemporaneamente i percorsi Std su ogni arco condiviso tra Partenza e Arrivo
• Tabella risultati estesa: mostra una riga per ogni arco con colonna dedicata "🔗 Arco" che identifica l'arco di appartenenza
• Percorsi Div per arco: ogni riga ha un bottone "▶ Percorso Div" per calcolare il percorso diversificato specifico per quell'arco
• Visualizzazione mappa singola: bottone "🗺️" per visualizzare sulla mappa il singolo percorso di un arco specifico
• Mappa Multi-Arco: visualizza tutti i percorsi di tutti gli archi sulla stessa mappa per un confronto visivo immediato
• Export TXT Multi-Arco: esporta tutti i percorsi con indicazione dell'arco di appartenenza e eventuale Div calcolato

Algoritmo Dijkstra Modificato

Il core di CRO utilizza una variante ottimizzata dell'algoritmo di Dijkstra per trovare i K-shortest paths (K=30) in un grafo pesato rappresentante la rete RC Italia.

Pseudocodice Dijkstra con Vincoli

function dijkstraWithConstraints(graph, start, end, constraints):
    // Inizializzazione
    distances = Map() // distanza minima da start
    previous = Map()  // nodo predecessore
    pqueue = PriorityQueue() // coda priorità (min-heap)
    
    // Imposta distanze iniziali
    for each node in graph.nodes:
        distances[node] = INFINITY
        previous[node] = NULL
    
    distances[start] = 0
    pqueue.push(start, 0)
    
    while pqueue is not empty:
        current = pqueue.pop()
        
        if current == end:
            break // Percorso trovato
        
        for each neighbor in graph.neighbors(current):
            // Applica vincoli
            if isBlacklisted(neighbor, constraints):
                continue
            
            if !meetsConstraints(neighbor, constraints):
                continue
            
            // Calcola distanza attraverso current
            alt = distances[current] + graph.weight(current, neighbor)
            
            if alt < distances[neighbor]:
                distances[neighbor] = alt
                previous[neighbor] = current
                pqueue.push(neighbor, alt)
    
    // Ricostruisci percorso
    return reconstructPath(previous, start, end)

Algoritmo Path Diversification (Div)

Per calcolare i 10 percorsi alternativi diversificati (Div), CRO implementa un algoritmo di penalizzazione archi per garantire overlap massimo 30% rispetto al percorso primario 1.1.

function calculateDiversifiedPaths(graph, start, end, primaryPath):
    diversifiedPaths = []
    primaryEdges = Set(primaryPath.edges)
    
    for i = 1 to 10:
        // Penalizza archi del percorso primario
        tempGraph = graph.clone()
        for each edge in primaryEdges:
            tempGraph.weight(edge) *= 10
        
        // Calcola percorso alternativo
        altPath = dijkstra(tempGraph, start, end)
        
        // Valida overlap
        overlap = calculateOverlap(altPath, primaryPath)
        if overlap <= 0.30:
            diversifiedPaths.push(altPath)
            // Aggiungi archi di altPath al set di penalizzazione
            primaryEdges.addAll(altPath.edges)
        
        if diversifiedPaths.length >= 10:
            break
    
    return diversifiedPaths

Validazione Topologica

CRO esegue validazioni automatiche su ogni percorso calcolato:

1. Connessione Fisica - Ogni hop deve essere un collegamento esistente in LINKS
2. Rispetto Vincoli - Centrali obbligatorie presenti, blacklist rispettate
3. Range Distanza - Distanza totale tra min/max specificati
4. Range Collegamenti - Numero hop tra min/max specificati
5. Stato Collegamenti - Se "Solo NON ATTIVI" attivo, tutti gli hop devono essere NON_ATTIVO
6. Tipo Centrali - Validazione sequenze Tipo 1 ↔ Tipo 2 (Tipo 3 trasparente)
7. No Loops - Nessuna centrale visitata più volte nel percorso

Eliminazione Duplicati

Percorsi identici (stessa sequenza centrali) vengono eliminati tramite hash-based deduplication. Hash calcolato: SHA256(centrali.join('-')). Complessità: O(N) con N=numero percorsi.

Schema Centrali (NODES)

Ogni centrale è rappresentata da un oggetto JSON con i seguenti campi:

Schema Collegamenti (LINKS)

Ogni collegamento è rappresentato da un oggetto JSON con i seguenti campi:

Relazioni e Integrità Referenziale

Indicizzazione e Performance

Indici creati per query ottimali:

Formato Storage JSON

Esempio record completo:

{
  "NODES": [
    {
      "id": "ROMA001",
      "name": "ROMA SUD",
      "clli": "RMITSUD",
      "gat": "RM9876",
      "lat": 41.891234,
      "lon": 12.512345,
      "zona": "RM",
      "area": "CENTRO",
      "regione": "Lazio",
      "TipoSede": "Tipo 1"
    }
  ],
  "LINKS": [
    {
      "id": "LINK12345",
      "from": "ROMA001",
      "to": "MILANO001",
      "from_name": "ROMA SUD",
      "to_name": "MILANO NORD",
      "distance_km": 476.32,
      "stato": "ATTIVO",
      "zona": "RM",
      "arco": "Arco_1",
      "Prog": "1-2-3-4"
    }
  ]
}

Funzioni Core di Routing

// Esempio uso
document.getElementById('btn-search').onclick = runBaseRoutesSearch;

// Esempio uso
const result = calculateShortestPath('ROMA001', 'MILANO001', {
  mandatory: ['FIRENZE001'],
  blacklist: ['BOLOGNA001'],
  maxDistance: 600
});
console.log(result.path); // ['ROMA001', 'FIRENZE001', 'MILANO001']

Funzioni Database

// Esempio uso
const results = searchNodes('ROMA');
results.forEach(node => console.log(node.name));

Funzioni Mappa

// Esempio uso
const polyline = drawRouteOnMap(['ROMA001', 'FIRENZE001'], '#0066CC');
polyline.bindPopup('Percorso ROMA-FIRENZE');

Funzioni Export

Eventi e Callbacks

Catalogo Error Codes

Debug Workflow Step-by-Step

Log Analysis

Console Browser - Messaggi Chiave da Monitorare:

// Log successo
[CRO] Database caricato: 500 centrali, 5700 collegamenti
[CRO] Calcolo completato in 187ms: 30 percorsi trovati

// Log warning
[CRO] Warning: Blacklist contiene 50% centrali - percorsi limitati
[CRO] Warning: Timeout OSRM - routing stradale non disponibile

// Log errore
[CRO] Error ERR_002: Nessun percorso tra ROMA001 e ISOLA_X
[CRO] Error: Mappa non inizializzata - retry in 2s

Problemi Comuni e Fix Rapidi

Benchmark Reference

Tempi medi su hardware standard (Intel i5, 8GB RAM, Chrome):

Ottimizzazioni Implementate

Best Practices Utilizzo

1. Chiudi tab non utilizzati - CRO usa ~150MB RAM, libera risorse
2. Usa Chrome o Firefox - Engine JavaScript 20% più veloce di Safari/Edge
3. Limita vincoli - Ogni vincolo aggiuntivo aumenta complessità ~15%
4. Calcola percorsi in batch - Evita calcoli singoli ripetuti
5. Disabilita rendering mappa durante batch - 3x speedup su operazioni massive
6. Clear localStorage periodicamente - Ogni 50 ricerche per prevenire slow-down
7. Ricarica pagina dopo 100+ operazioni - Memory leaks minimi ma presenti

Configurazioni Avanzate (Sviluppatori)

// File: config.js - Performance Tuning

// Numero max percorsi da calcolare (default: 30)
const MAX_PRIMARY_ROUTES = 30; // Riduci a 10 per +70% speed

// Timeout calcolo (default: 30000ms)
const CALCULATION_TIMEOUT = 30000; // Aumenta se network complex

// Cache size (default: 100)
const CACHE_SIZE = 100; // Aumenta a 500 per +10% hit rate

// Virtual scrolling threshold (default: 1000)
const VIRTUAL_SCROLL_THRESHOLD = 1000; // Riduci a 500 per low-end

// Debounce delay (default: 300ms)
const DEBOUNCE_DELAY = 300; // Riduci a 150ms per UX più reattiva

Formati Export Supportati

PERCORSI PRIMARI (Std):
===================================
1.1 | ROMA SUD → FIRENZE NORD → MILANO CENTRO | 476.32 km | 2 hop
    Collegamenti: LINK001, LINK045
    ID: ROMA001-FIRENZE001-MILANO001

PERCORSI ALTERNATIVI (Div):
===================================
2.1 | ROMA SUD → BOLOGNA EST → MILANO CENTRO | 512.10 km | 2 hop
    Collegamenti: LINK078, LINK123
    Overlap: 15%

ID,Tipo,Centrali,Collegamenti,Distanza_km,Hop
1.1,Primario,"ROMA SUD|FIRENZE NORD|MILANO","LINK001|LINK045",476.32,2
2.1,Alternativo,"ROMA SUD|BOLOGNA EST|MILANO","LINK078|LINK123",512.10,2

Tool Esterni Compatibili

API Endpoints (Future Release)

Roadmap per integrazione backend:

Workflow Integrazione Tipico

A-D

Attenuazione (α)

Perdita di potenza segnale ottico lungo fibra. Unità: dB/km. Valori tipici: 0.22 dB/km @ 1550nm (SM)

CLLI (Common Language Location Identifier)

Codice standard ITU-T E.164 per identificazione univoca centrali/siti. Formato: 8-11 caratteri alfanumerici

CR/GI (Change Request / Gestione Impianti)

Processi Telecom Italia per richieste modifiche rete e gestione asset infrastrutturali

Dijkstra

Algoritmo greedy per shortest path in grafi pesati. Complessità: O(|E| + |V|log|V|) con Fibonacci heap

DWDM (Dense Wavelength Division Multiplexing)

Tecnologia multiplexing ottico con 40-80+ canali su singola fibra. Spacing: 50 GHz (ITU-T G.694.1)

E-H

EDFA (Erbium-Doped Fiber Amplifier)

Amplificatore ottico per banda C (1530-1565 nm). Gain tipico: 20-30 dB

GAT

Codice identificativo interno Telecom Italia per gestione asset territoriali

Haversine

Formula trigonometrica per calcolo distanza ortodromica (great-circle) su sfera. Errore <0.5% per distanze <1000 km

Hop

Singolo collegamento tra due centrali adiacenti. Count: numero totale collegamenti in un percorso

I-O

ITU-T (International Telecommunication Union - Telecom)

Organismo standardizzazione internazionale telecomunicazioni. Standard rilevanti: G.652 (fibra), G.694.1 (DWDM)

K-Shortest Paths

Algoritmo per trovare K percorsi più corti (non solo il migliore). CRO: K=30 per primari, K=10 per alternativi

Leaflet

Libreria JavaScript open-source per mappe interattive. Lightweight (39 KB gzipped)

Monomodale (SM - Single Mode)

Fibra ottica con core 9 μm. Per lunghe distanze (>2 km). Bande: O, E, S, C, L

Nominatim

Geocoding engine OpenStreetMap. API pubblica con rate limit: 1 req/sec

Overlap

Percentuale archi condivisi tra due percorsi. Formula: (Archi_comuni / Archi_totali) × 100

OSRM (Open Source Routing Machine)

Engine routing stradale basato su OpenStreetMap. Algoritmo: Contraction Hierarchies

P-Z

Percorso Primario (Std)

Percorso ottimizzato per distanza minima senza penalizzazioni. CRO calcola fino a 30 percorsi Std

Percorso Alternativo (Div)

Percorso diversificato con overlap <30% vs 1.1. Per ridondanza e disaster recovery

RA Italia (Rete Aggregation Italia)

Rete di aggregazione TIM che raccoglie traffico dalle centrali periferiche verso i nodi Core (NODO A1). Struttura gerarchica: Tipo 3 → Tipo 2 → Tipo 1

RC Italia (Rete Core Italia)

Backbone nazionale TIM S.p.A. Layer 0/1 (fibra/DWDM) per interconnessione centrali principali. Include 32 NODO A1 (POP nazionali)

Rete Revolution

Progetto TIM di evoluzione infrastruttura ottica nazionale. Modernizzazione rete trasporto con tecnologie DWDM di nuova generazione e incremento capacità

Tipo 1 / Tipo 2 / Tipo 3

Classificazione centrali TIM. Tipo 1: HUB RA+RC (NODO A1, interconnesso Core). Tipo 2: HUB RA (nodi intermedi). Tipo 3: Passaggio (endpoint/trasparenti)

WGS84 (World Geodetic System 1984)

Sistema riferimento geodetico standard GPS. Coordinate: latitudine (-90,+90), longitudine (-180,+180)

Standard ITU-T Riferimento

1. Raccolta requisiti da ticket CR/GI: centrali A-B, vincoli, requisiti di ridondanza
2. Verifica esistenza centrali nel database (tab "Database Rete")
3. Impostazione filtri geografici (es. solo Area LAZIO per ridurre search space)
4. Configurazione vincoli: centrali obbligatorie, centrali da evitare, distanza/hop min-max
5. Esecuzione ricerca: click "Avvia Ricerca" → elaborazione 2-10 secondi
6. Analisi risultati: confronto distanze, numero hop, percorsi dettagliati nella tabella
7. Visualizzazione mappa: click su percorso + "Visualizza su Mappa" per analisi topografica
8. Calcolo attenuazione: vai al tab "Calcolatore Attenuazione", inserisci lunghezza e tipo fibra
9. Selezione percorso ottimale: basati su distanza, attenuazione, diversificazione geografica
10. Export documentazione: esporta in TXT (allegato tecnico) o CSV (elaborazioni)
11. Archiviazione: salva screenshot mappa, allega export a ticket CR/GI, usa Undo per tornare indietro se necessario

Requisito CR/GI: Collegamento ROMA SUD → ROMA INVIOLATELLA con transito per ROMA OSTIENSE.

Procedura:

1. Tab "Ricerca Percorsi": inserisci Partenza: "ROMA SUD"
2. Inserisci Arrivo: "ROMA INVIOLATELLA"
3. In "Centrali Obbligatorie" seleziona: ROMA OSTIENSE
4. Opzionale: imposta Distanza Max: 50 km
5. Click "Avvia Ricerca"

Risultato atteso:

Il sistema calcola percorsi che DEVONO passare per ROMA OSTIENSE. Ricevi:

• Percorso primario 1.1: ROMA SUD → ROMA OSTIENSE → ROMA INVIOLATELLA
• Percorsi alternativi 2.1, 2.2, ... (se esistono) geograficamente diversificati
• Distanze parziali per ogni hop
• Coordinate WGS84 di ogni centrale attraversata

Verifica attenuazione:

Se il percorso 1.1 è lungo 35 km con 3 collegamenti (6 connettorizzazioni), vai al tab "Calcolatore Attenuazione":

• Lunghezza tratta: 35 km
• Tipo fibra: SM 1550 nm (α = 0.22 dB/km)
• Collegamenti: 3 (= 6 connettorizzazioni × 0.3 dB)

Risultato: Perdita totale = (35 × 0.22) + (6 × 0.3) = 7.7 + 1.8 = 9.5 dB
Dentro budget tipico OTN (15-20 dB) → ✓ Collegamento FATTIBILE

Giuseppe Lupoli